@amplitude/plugin-web-attribution-browser

What is @amplitude/plugin-web-attribution-browser?

@amplitude/plugin-web-attribution-browser is a plugin for Amplitude's analytics platform that helps in tracking and attributing web traffic. It allows you to understand the source of your web traffic, track user interactions, and attribute conversions to specific marketing campaigns or channels.

What are @amplitude/plugin-web-attribution-browser's main functionalities?

Initialize Web Attribution

This feature initializes the web attribution plugin with Amplitude's analytics. It sets up the necessary configurations to start tracking web traffic and attributing it to specific sources.

const amplitude = require('@amplitude/analytics-browser');
const { webAttributionPlugin } = require('@amplitude/plugin-web-attribution-browser');

amplitude.init('YOUR_API_KEY');
amplitude.add(webAttributionPlugin());

Track Page Views

This feature allows you to track page views on your website. By sending a 'Page View' event with the current page's pathname, you can monitor which pages are being visited by users.

amplitude.track('Page View', { page: window.location.pathname });

Attribute Conversions

This feature enables you to attribute conversions to specific campaigns and sources. By sending a 'Conversion' event with details about the campaign and source, you can measure the effectiveness of your marketing efforts.

amplitude.track('Conversion', { campaign: 'Summer Sale', source: 'Google Ads' });

Other packages similar to @amplitude/plugin-web-attribution-browser

mixpanel-browser

Mixpanel's browser library allows you to track user interactions and attribute them to specific sources. It offers similar functionalities to @amplitude/plugin-web-attribution-browser, such as tracking events, page views, and conversions. However, Mixpanel provides more advanced features like A/B testing and user segmentation.

google-analytics

Google Analytics is a widely-used web analytics service that tracks and reports website traffic. It provides comprehensive web attribution features, allowing you to understand the sources of your traffic and measure conversions. Compared to @amplitude/plugin-web-attribution-browser, Google Analytics offers more extensive reporting and integration with other Google services.

README

@amplitude/plugin-web-attribution-browser

Official Browser SDK plugin for web attribution tracking

Installation

This package is published on NPM registry and is available to be installed using npm and yarn.

# npm
npm install @amplitude/plugin-web-attribution-browser@^1.0.0

# yarn
yarn add @amplitude/plugin-web-attribution-browser@^1.0.0

Usage

This plugin works on top of Amplitude Browser SDK and adds web attribution tracking features to built-in features. To use this plugin, you need to install @amplitude/analytics-browser version v1.4.0 or later.

1. Import Amplitude packages

• @amplitude/analytics-browser
• @amplitude/plugin-web-attribution-browser

import * as amplitude from '@amplitude/analytics-browser';
import { webAttributionPlugin } from '@amplitude/plugin-web-attribution-browser';

2. Instantiate page view plugin

The plugin requires 1 parameter, which is the amplitude instance. The plugin also accepts an optional second parameter, which is an Object to configure the plugin based on your use case.

const webAttributionTracking = webAttributionPlugin(amplitude, {
  disabled: undefined,
  excludeReferrers: undefined,
  initialEmptyValue: undefined,
  resetSessionOnNewCampaign: undefined,
});

Options

Name	Type	Default	Description
disabled	boolean	false	Use this option to enable or disable web attribution tracking. By default, upon installing this plugin, web attribution tracking is enabled.
excludeReferrers	string[]	[]	Use this option to prevent the plugin from tracking campaigns parameters from specific referrers. For example: subdomain.domain.com.
initialEmptyValue	string	"EMPTY"	Use this option to specify empty values for first-touch attribution.
resetSessionOnNewCampaign	boolean	false	Use this option to control whether a new session should start on a new campaign.

3. Install plugin to Amplitude SDK

amplitude.add(webAttributionTracking);

4. Initialize Amplitude SDK

amplitude.init('API_KEY');

Resulting web attribution event

This plugin tracks campaign parameters based on your configuration. A web attribution event is composed of the following values:

Event type

• "$idenfity"

User properties

Property	Description
utm_source	URL query parameter value for utm_source
utm_medium	URL query parameter value for utm_medium
utm_campaign	URL query parameter value for utm_campaign
utm_term	URL query parameter value for utm_term
utm_content	URL query parameter value for utm_content
referrer	Referring webstite or document.referrer
referring_domain	Referring website's domain, including subdomain
dclid	URL query parameter value for dclid
gbraid	URL query parameter value for gbraid
gclid	URL query parameter value for gclid
fbclid	URL query parameter value for fbclid
ko_click_id	URL query parameter value for ko_click_id
li_fat_id	URL query parameter value for li_fat_id
msclkid	URL query parameter value for msclkid
rtd_cid	URL query parameter value for rtd_cid
ttclid	URL query parameter value for ttclid
twclid	URL query parameter value for twclid
wbraid	URL query parameter value for wbraid